Creating and Manipulating Format Objects(IM:XP)

Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions

Creating and Manipulating Format Objects
When a user creates a new document, clicks on a page, and chooses the Format button in the Custom Page Setup dialog box, you use the GXNewFormat function to create a new format object.
When a user wants to modify a format for a single page that is also shared by other pages in the same document, the user wants to return to the default format, or the user decides not to save a format, you use the GXDisposeFormat function to dispose of the format object, which decrements its owner count.
When a user wants to disassociate a format from a particular document and associate it with another document, you use the GXCopyFormat function to copy a format object. When a user wants to share a format, created using the Custom Page Setup dialog box, with an additional page in the same document, you use the GXCloneFormat function to clone a format object. This function increments the owner count.
You can use the GXCountJobFormats function to obtain the number of format objects in a particular document, and you can use the GXForEachJobFormatDo function to make changes to each format object associated with a printable document. You can use the GXCountFormatOwners function to determine the number of references to a format object.

Subtopics

GXNewFormat

GXDisposeFormat

GXCopyFormat

GXCloneFormat

GXCountJobFormats

GXCountFormatOwners

GXForEachJobFormatDo